Skip to main content

​
Import

import { useWalletSettings } from '@0xsequence/connect'

​
Usage

import { useWalletSettings } from '@0xsequence/connect'

function WalletConfigPanel() {
  const { displayedAssets, readOnlyNetworks, setDisplayedAssets } = useWalletSettings()
  
  // Example function to add a new asset
  const addNewAsset = (contractAddress: string, chainId: number) => {
    setDisplayedAssets([
      ...displayedAssets,
      { contractAddress, chainId }
    ])
  }
  
  // Example function to check if network is read-only
  const isNetworkReadOnly = (chainId: number) => {
    return readOnlyNetworks?.includes(chainId)
  }
  
  return (
    <div>
      <h2>Wallet Settings</h2>
      
      <div>
        <h3>Displayed Assets</h3>
        <ul>
          {displayedAssets.map(asset => (
            <li key={`${asset.chainId}-${asset.contractAddress}`}>
              Chain ID: {asset.chainId}, Contract: {asset.contractAddress}
            </li>
          ))}
        </ul>
        
        <button
          onClick={() => addNewAsset('0x1234...', 1)}
          disabled={isNetworkReadOnly(1)}
        >
          Add ETH Mainnet Asset
        </button>
      </div>
      
      <div>
        <h3>Network Status</h3>
        <ul>
          {[1, 137, 10].map(chainId => (
            <li key={chainId}>
              Chain {chainId}: {isNetworkReadOnly(chainId) ? 'Read-only' : 'Active'}
            </li>
          ))}
        </ul>
      </div>
    </div>
  )
}

​
Return Type

interface WalletSettingsReturn {
  displayedAssets: Array<{
    contractAddress: string
    chainId: number
  }>
  readOnlyNetworks: number[] | undefined
  setDisplayedAssets: (assets: Array<{
    contractAddress: string
    chainId: number
  }>) => void
}

​
Properties

​
displayedAssets

Array<{ contractAddress: string, chainId: number }> Array of assets to display in the wallet interface. Each asset is defined by:
  • contractAddress: The token contract address
  • chainId: The network ID where the token exists

​
readOnlyNetworks

number[] | undefined Array of network IDs where transactions are disabled. These networks are available for viewing balances and transaction history, but users cannot initiate new transactions.

​
setDisplayedAssets

(assets: Array<{ contractAddress: string, chainId: number }>) => void Function to update the list of displayed assets. Takes an array of asset objects, each containing a contract address and chain ID.

​
Notes

This hook provides access to wallet display settings and network status information. Key features:
  • Asset display list management
  • Read-only network status information
  • Type-safe configuration updates
Common use cases:
  • Managing visible token list
  • Checking if networks are read-only
  • Building settings interfaces
Best practices:
  • Validate contract addresses before adding to displayed assets
  • Check network read-only status before attempting transactions
  • Keep displayed assets list up to date
The hook is commonly used in wallet configuration interfaces to manage which assets are displayed and check network status.